home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / comms / freevi10.zip / FREEVIEW.DOC < prev    next >
Text File  |  1994-04-20  |  6KB  |  167 lines
  1.                                    Freeview  
  2.  
  3.                                   Version 1.0
  4.  
  5.                                  - Freeware -
  6.  
  7.                           Copyright 1994 Wayne Thomas
  8.  
  9.  
  10. Introduction
  11. ============
  12.  
  13.   Freeview is a simple RIP viewer for viewing RIPs at the command line.  
  14.   Unlike other RIP viewers, it supports and displays every RIP command in
  15.   the RIPscrip 1.54 standard.  This allows it to properly display nearly 
  16.   every RIP file there is.  The RIP playback can be aborted by pressing any 
  17.   key.  If a wildcard is used in the file name, the RIP file name will be 
  18.   shown at the bottom of the screen when the RIP is done displaying.
  19.  
  20.   Freeview is freeware.  This means that you can give unmodified copies 
  21.   of it to other people and upload it to BBSs.
  22.  
  23.  
  24. Requirements
  25. ============
  26.  
  27.   EGA, VGA or better graphics.  (at least 256Kb on the video board)
  28.   Approximately 300Kb free memory.
  29.  
  30.  
  31. Disclaimer
  32. ==========
  33.  
  34.  No warranty is expressed or implied.  Use at your own risk.  The author 
  35.  will not be held responsible for any damages from the use of this product.  
  36.  It has been tested on many systems without problems, but it has not or could 
  37.  not have been tested on every type of system.
  38.  
  39.  
  40. Command Line Options
  41. ====================
  42.  
  43.   Freeview's command line syntax:
  44.   -------------------------------
  45.  
  46.     FREEVIEW [PATH]FILENAME[.RIP] [OPTIONS]
  47.  
  48.     The items in [brackets] are optional.  Wildcards are fully supported.
  49.     Example:  freeview menu? /text /trace
  50.     
  51.  
  52.   Freeview's options:
  53.   -------------------
  54.  
  55.     /ICON:ICONDIR      
  56.  
  57.     This specifies an auxiliary icon directory.  Some RIP files will want to
  58.     load icon files (*.ICN) and display them on the screen.  Freeview will
  59.     first check the current directory first for the icon files, and if they
  60.     are not there, it will check in the auxiliary directory.  If no auxiliary
  61.     directory is specified, then it will check the directory where freeview
  62.     resides.
  63.  
  64.     Examples:  /ICON:C:\RIPTERM\ICONS    
  65.                -icon:d:\ripaint\icons\
  66.  
  67.     /TEXT
  68.  
  69.     This option tells Freeview to display any ASCII, non RIP characters in the
  70.     text window.  There are five different font sizes that can be displayed
  71.     in this window.  The text window will begin scroll once it is full.  ANSI
  72.     graphics is not yet supported.  Something to look forward to in future 
  73.     versions.
  74.  
  75.     /CPS:XXXX
  76.  
  77.     This option will slow down the speed of the RIP files being displayed. 
  78.     XXXX is the number of characters per second.  Up to four digits are 
  79.     allowed.
  80.  
  81.     Example:  /CPS:240  (simulates 2400 BPS modems)
  82.  
  83.     /TRACE
  84.  
  85.     With this option, the RIP will be displayed command by command.  Pressing
  86.     a key will go to the next command.  The RIP code and any ASCII text will 
  87.     be displayed at the bottom of the screen.
  88.  
  89.     /SS:XX
  90.  
  91.     With is option, RIPs will be displayed in slide show mode.  XX is the 
  92.     number of seconds between each RIP.  Up to two digits are allowed.
  93.  
  94.     Example:  /SS:15
  95.  
  96.  
  97.   Notes
  98.   -----
  99.  
  100.      All options must be separated by at least one space character.  The minus
  101.      character '-' can be used instead of the slash '/' character.  The 
  102.      filename and options are not case sensitive.
  103.  
  104.      If you want to use a command line option all the time, then it is 
  105.      recommended that you make a batch file.  Example: 
  106.      
  107.      fv.bat:
  108.  
  109.      @echo off
  110.      c:\util\freeview %1 %2 %3 -text -icon:c:\ripterm\icons
  111.  
  112.  
  113. Technical Notes
  114. ===============
  115.  
  116.   Freeview is written in Turbo Pascal 6.0, and some assembly language.
  117.   All the RIPscrip commands are supported that do something to the
  118.   display.  Some of the active text variables are not supported yet.
  119.   The six variables that support sound effects are supported.  A few 
  120.   other active text variables are also supported.
  121.  
  122.   All eleven RIP fonts are supported and are built in.  Five different 
  123.   fonts sizes are supported for the text window.
  124.  
  125.   Variable width parameters are also supported.  Most other RIP viewers
  126.   do not support this option, even though it is documented in the RIPscrip
  127.   standard.
  128.  
  129.   Some mouse buttons may not look correct, there are so many possible 
  130.   combinations for buttons, it is impossible to test them all.  If you
  131.   have some RIP files that do not display correctly with Freeview, but do 
  132.   display correctly with RIPterm, please send them to me so I can find 
  133.   the problem with Freeview and fix it.
  134.  
  135.   If there is a command in the RIP file to save an icon, the icon will be
  136.   saved in the current directory.  This is done so that none of the icons
  137.   in the auxiliary directory are overwritten.
  138.  
  139.   If there is a command in RIP file to load and display another RIP file, 
  140.   Freeview will only look for that file in the current directory.
  141.  
  142.   If Freeview detects any RIP commands that are invalid, it will not display
  143.   them, instead it will give out a low beep and briefly show the command at
  144.   the bottom of the screen.  If some important things are missing, flood 
  145.   fills could escape and wipe out the image on the screen.  There is the 
  146.   slight possibility that Freeview could lock up during one of these flood
  147.   fills, so it is a good idea to abort viewing the image when invalid
  148.   commands are encountered.
  149.  
  150.  
  151. Contacting the author
  152. =====================
  153.  
  154.   I can be reached with a public message in the RIP conference in the following 
  155.   nets: RIME, Intelec, ILink, ICN.  I can also be reached at the Brewster BBS,
  156.   (914) 279-2514.  The latest version of Freeview will be uploaded there as 
  157.   soon as it become available.
  158.  
  159.   Also by the author:  RIP Sketch, a shareware RIP drawing program.
  160.  
  161.  
  162. Trademarks
  163. ==========
  164.  
  165.   RIPscrip, RIPterm and RIPaint are trademarks of TeleGrafix Communications, 
  166.   Inc.
  167.